home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / ppp106.arc / PPP106.DOC < prev   
Text File  |  1987-05-07  |  18KB  |  727 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                     Programmable Printer PopUp Users Guide
  23.  
  24.  
  25.            (c) Copyright 1987, Mark Allen Neil, All Rights Reserved
  26.  
  27.  
  28.                                  Revision 1.06
  29.  
  30.  
  31.                                     5/6/87
  32.  
  33.  
  34.  
  35.  
  36.  
  37. Programmable Printer PopUp Users Guide                            Version 1.06
  38.  
  39.  
  40.  
  41.  
  42.                  Welcome to PPP - Programmable Printer Pop-Up
  43.  
  44.  
  45.      This program is being distributed as user-supported software.
  46.  
  47.      A limited license is granted to all users of this program, to make
  48.      copies of this program and distribute them to other users, with the
  49.      following conditions :
  50.  
  51.      1. The program is not to be distributed to others in modified form.
  52.      2. No fee is to be charged (or any other consideration received) for
  53.         copying or distributing the program without an express written
  54.         agreement with :
  55.                                 Mark Allen Neil
  56.                                 5627 Silver Leaf Road
  57.                                 San Jose, CA  95138
  58.  
  59.      You are encouraged to copy and share this program with other users.
  60.  
  61.      If you use this program at home, enjoy it!  If you use this program at
  62.      work, convince your boss to send me a contribution of $20.00.  The way I
  63.      look at it, if your boss is willing to spend $700.00 for a spreadsheet or
  64.      database manager, he can afford to fork out a few bucks for this product.
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                     2
  97.  
  98.  
  99.  
  100. Programmable Printer PopUp Users Guide                            Version 1.06
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                 Table Of Contents
  107.  
  108.  
  109.  
  110.           1.0  Introduction
  111.  
  112.           2.0  Features
  113.  
  114.             2.1  Important files
  115.             2.2  The PPP Main Menu
  116.             2.3  The Help Menu
  117.             2.3.1  The HotKey Menu
  118.             2.3.2  The Printer Selection Menu
  119.  
  120.           3.0  Command Line Switches
  121.  
  122.           4.0  Printer Definition Files
  123.  
  124.           5.0  Acknowledgments
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                     3
  160.  
  161.  
  162.  
  163. Programmable Printer PopUp Users Guide                            Version 1.06
  164.  
  165.  
  166.  
  167.  1.0  Introduction
  168.  
  169.      Programmable printer popup (PPP) is a utility which allows you to send
  170.      configuration codes to your printer.  PPP can be loaded as a resident
  171.      utility (40 K), or it can be executed from a run time prompt with command
  172.      line parameters.  This document will explain in detail what PPP does, and
  173.      how to use it to your advantage.  First, however, I would like to give you
  174.      some background on why I wrote this program.
  175.  
  176.      I recently purchased a dot-matrix printer, the Toshiba P321 to be exact.
  177.      I bought this printer because it has beautiful letter quality print and a
  178.      very fast, very legible draft mode.  Unfortunately, many software
  179.      packages fail to support this printer, and I did not purchase an
  180.      emulation option.  I immediately began searching through the bulletin
  181.      boards to which I belong for a resident printer control program for the
  182.      P321.  I found a few programs which would configure the printer, but none
  183.      which were resident, and to be honest, none which had a sensible screen
  184.      layout (ALL programmers want it done THEIR way).
  185.  
  186.      It occurred to me that others might also have non-EPSON printers, and
  187.      might like a utility to allow them to configure their printers.
  188.  
  189.      I started off by writing a simple program in TURBO PASCAL to send
  190.      configuration codes to the printer.  Then I made the whole mess resident
  191.      using some PASCAL source routines downloaded from a local BBS (see
  192.      acknowledgements).  Finally I sped the screen I/O up with some different
  193.      source routines, also downloaded (again, see acknowledgements).
  194.  
  195.      You might point out that much of my work was "borrowed", but I am
  196.      distributing this FREE, and giving credit where credit is due.  The folks
  197.      in the acknowledgement section are terrific programmers.  Their work made
  198.      my final product slicker and faster, and it is appreciated.
  199.  
  200.      One last note : I will be using trade names in this document (e.g. EPSON)
  201.      without designating the owner, but I will clearly designate trade names
  202.      in capital letter.  I hope my use of the trade names doesn't step on
  203.      anyone's toes.
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                     4
  223.  
  224.  
  225.  
  226. Programmable Printer PopUp Users Guide                            Version 1.06
  227.  
  228.  
  229.  
  230.  2.0  Features
  231.  
  232.      PPP was designed to be as easy to use as possible.  There are now two or
  233.      three printer popup programs on the market which have more features, but
  234.      there are advantages to a program with fewer features :
  235.  
  236.       - Easier to learn
  237.       - Easier to use
  238.       - 80 % of the "nifty" features are useless day to day
  239.       - PPP is FREE
  240.  
  241.  2.1  Important files
  242.  
  243.      There are 2 basic files which make up the PPP package.  The first is the
  244.      PPP program file, called PPP.COM.  The other file(s) are called "printer
  245.      definition files".  Each one of these files has the extension ".PPP", e.g.
  246.      P321.PPP.  The printer definition files define the control codes which PPP
  247.      will send to the printer.  You may have several printer control files, and
  248.      you can switch between them at will.
  249.  
  250.  
  251.  2.2  The PPP Main Menu
  252.  
  253.      When PPP is invoked, either from a command line or by pressing the
  254.      "hotkey", the user is presented with a menu of choices.  This menu consists
  255.      of a list of "options" from which the user can select.  Any combination of
  256.      options can be selected.  An option is selected by moving the ">" character
  257.      up or down to the desired option and pressing the space bar.  Options can
  258.      be toggled off and on by pressing the space bar repeatedly.  An option is
  259.      "selected" when it appears in reverse video.
  260.  
  261.      An "option" is something you would like to tell the printer to do.  For
  262.      example, turning on bold print, enabling compressed mode, or even sending
  263.      the string "Dear Sir," to the printer.  The definition of each option is
  264.      completely under the users control, because the user can customize his
  265.      option menu (Section 4).
  266.  
  267.      When finished selecting options, the user can either hit <RETURN> to send
  268.      the codes to the printer, or <ESC> to exit PPP with no action.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                     5
  286.  
  287.  
  288.  
  289. Programmable Printer PopUp Users Guide                            Version 1.06
  290.  
  291.  
  292.      Below is an example of a PPP main menu designed for use with the Toshiba
  293.      P321 printer :
  294.  
  295.                         +============================+
  296.      Title ------->     |     P321 Printer Control   |
  297.                         +----------------------------+
  298.                         |                            |
  299.      Options ----->     | > Eject Page               |
  300.      (up to 16)         |   High Speed               |
  301.                         |   Quality Elite            |
  302.                         |   Quality Courier          |
  303.                         |   10.0 cpi                 |
  304.                         |   12.0 cpi                 |
  305.                         |   16.7 cpi                 |
  306.                         |   Italics On               |
  307.                         |   Italics Off              |
  308.                         |   Bold On                  |
  309.                         |   Bold Off                 |
  310.                         |   "DEAR SIR,"              |
  311.      F1 key brings up   |                            |
  312.      Help Menu ---->    +========[ F1 - HELP ]=======+
  313.  
  314.  
  315.  2.3  The Help Menu
  316.  
  317.      If you have trouble remembering what to do, pressing the F1 key will bring
  318.      up a help menu screen.
  319.  
  320.      This is the PPP Help screen :
  321.  
  322.  
  323.                  +==========================================+
  324.                  |             PPP Help Screen              |
  325.                  +------------------------------------------+
  326.                  | <UP ARROW>     Select previous option    |
  327.                  | <DOWN ARROW>   Select next option        |
  328.                  | <SPACE BAR>    Toggle highlighting       |
  329.                  | <ESC>          Exit without action       |
  330.                  | <RETURN>       Send highlighted commands |
  331.                  |                to printer                |
  332.                  +------------------------------------------+
  333.                  | F9             Change Hotkey             |
  334.                  | F10            Change Printer File       |
  335.                  +========[ Hit any key to exit help ]======+
  336.  
  337.      This screen gives a short description of the keys used in the PPP main
  338.      menu.  There are 2 functions which can be accessed from this menu, changing
  339.      the "hotkey" (F9 key) and changing the current printer file (F10 key).
  340.      Hitting any other key will cause you to return to the main menu.
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                     6
  349.  
  350.  
  351.  
  352. Programmable Printer PopUp Users Guide                            Version 1.06
  353.  
  354.  
  355.  2.3.1  The HotKey Menu
  356.  
  357.      The HotKey menu appears if the user presses F9 from the Help menu.  The
  358.      "hotkey" is the key, or combination of keys which causes a resident PPP to
  359.      appear on the screen.  The hotkey is unimportant when PPP is used as a non-
  360.      resident utility.  The default hotkey used by PPP is "<ALT> P" (see
  361.      SAMPLE.BAT).  When the HotKey menu appears, hit the key combination that
  362.      you want to invoke PPP.  Choose a combination which doesn't conflict with
  363.      the software you use most often.  When you enter the new combination, a
  364.      three digit representation of this number will appear on the menu for three
  365.      seconds, and then control will return to the Main menu.  If you enter the
  366.      HotKey menu and decide not to change the current hotkey, press the <ESC>
  367.      key.
  368.  
  369.      To permanently change the hotkey, write down the number which appears next
  370.      to "Current Hotkey", and edit this number into the batch file which starts
  371.      PPP (Section 3).
  372.  
  373.      This is the PPP HotKey screen :
  374.  
  375.                                +======================+
  376.                                |  Hit Key Combination |
  377.                                |    for New HotKey    |
  378.                                |                      |
  379.                                | Current Hotkey = 281 |
  380.                                |                      |
  381.                                | New Hotkey     =     |
  382.                                |                      |
  383.                                +==[ <ESC> to Abort ]==+
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                     7
  412.  
  413.  
  414.  
  415. Programmable Printer PopUp Users Guide                            Version 1.06
  416.  
  417.  
  418.  2.3.2  The Printer Selection Menu
  419.  
  420.      The Printer Selection menu appears if the user presses F10 from the Help
  421.      menu.  This menu presents a list of all of the printer definition files
  422.      (*.PPP) in the PPP default directory (where PPP was invoked).  The first
  423.      printer listed appears in reverse video.  Use the up and down arrow keys to
  424.      highlight a new printer, and hit <RETURN> to select the new printer.  PPP
  425.      will default upon initialization to the first printer definition file it
  426.      finds in the current directory.
  427.  
  428.      To permanently change the default printer definition file, edit the name of
  429.      the file into the batch file which starts PPP (Section 3).
  430.  
  431.      This is the PPP Printer Selection screen :
  432.  
  433.  
  434.                                  +==========+
  435.                                  | Printers |
  436.                                  +----------+
  437.              Printer definition  | P321     |
  438.              files ------ >      | EPSON    |
  439.                                  | OKIDATA  |
  440.                                  | CITIZEN  |
  441.                                  +==========+
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                     8
  475.  
  476.  
  477.  
  478. Programmable Printer PopUp Users Guide                            Version 1.06
  479.  
  480.  
  481.  
  482.  3.0  Command Line Switches
  483.  
  484.      The default configuration of PPP can be modified by entering new defaults
  485.      on the command line, preceded by "switches".  The command line switches
  486.      recognized by PPP are defined as follows :
  487.  
  488.      -R [or \R] nnn   :  This is the Residency switch.  If you want PPP to be a
  489.                          resident application, include this switch.  The default
  490.                          in non-resident.  The "nnn" is the 3 digit hotkey which
  491.                          causes PPP to appear (Section 2.3.1).
  492.  
  493.      -D [or \D] fname :  This is the Default printer configuration file name
  494.                          switch.  This switch tells PPP which printer
  495.                          configuration file to use.  If this switch is omitted,
  496.                          PPP will find the first "PPP" file in the directory
  497.  
  498.      -Q [or \Q]       :  This is the "quick" startup switch, and disables the
  499.                          startup screen.  PPP would be an impractical
  500.                          tool if you had to see my name all the time, but at
  501.                          least the first time you will see who wrote PPP.
  502.  
  503.      Examples :
  504.  
  505.      A>PPP               invoke PPP, non-resident, default to first .PPP file
  506.  
  507.      A>PPP -Q -R 281     invoke PPP, resident with <ALT> P, no startup screen
  508.  
  509.      A>PPP \Q \D EPSON   invoke PPP, non-resident, default to EPSON.PPP
  510.                          configuration file, no startup screen
  511.  
  512.      A>PPP -Q -R 359 -D P321   invoke PPP, resident with <CNTL> F10, default to
  513.                                P321.PPP configuration file, no startup screen
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                     9
  538.  
  539.  
  540.  
  541. Programmable Printer PopUp Users Guide                            Version 1.06
  542.  
  543.  
  544.  4.0  Printer Definition Files
  545.  
  546.      PPP is useless without a definition of control commands to send to the
  547.      printer.  Each printer must have at least one printer definition file
  548.      defining the control commands.  Printer definition files must have the
  549.      extension ".PPP", and they must exist in the directory from which PPP is
  550.      invoked.  Printer definition files are in ASCII format, e.g. they can
  551.      contain no control characters nor tabs.  When editting or creating a new
  552.      printer definition file, edit your work using a "non-document" mode, or
  553.      use a straight ASCII editor, such as PC-Write.
  554.  
  555.      The first line of a printer definition file contains the title.  This title
  556.      appears in the PPP main menu.  The title cannot be more than 40 characters
  557.      in length.
  558.  
  559.      Examples :
  560.  
  561.      P321 Printer Control
  562.  
  563.      Mark's Special Control Menu
  564.  
  565.  
  566.      The next sequence of lines define the printer control options.  Each line
  567.      defines a separate control option.  There can be up to 16 options in each
  568.      file.  Each control option has two parts, the option name, and a sequence
  569.      of decimal byte (< 256) values to send to the printer when that option is
  570.      selected.  The option field occupies the first 40 characters of the line,
  571.      and the byte values follow on the same line anywhere after column 40.
  572.      There can be no additional spaces following the last control byte on a
  573.      line.
  574.  
  575.      Examples :
  576.  
  577.      Option name                           40   Control bytes
  578.  
  579.      Eject Page                               12
  580.  
  581.      10.0 cpi                                             27 42 48 27 69 49 50
  582.  
  583.      "DEAR SIR,"                             68 69 65 82 32 83 73 82 44 13 10
  584.  
  585.  
  586.      The last example above send the string "DEAR SIR," to the printer.
  587.  
  588.      After the last option line, the next line must contain a star "*",
  589.      signifying the end of the printer definition file.
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                    10
  601.  
  602.  
  603.  
  604. Programmable Printer PopUp Users Guide                            Version 1.06
  605.  
  606.  
  607.  
  608.      Sample printer definition file for Toshiba P321 printer :
  609.  
  610.  
  611.      P321 Printer Control
  612.      Eject Page                               12
  613.      High Speed                               27 42 48
  614.      Quality Elite                            27 42 49
  615.      Quality Courier                          27 42 50
  616.      10.0 cpi                                 27 42 48 27 69 49 50
  617.      12.0 cpi                                 27 42 48 27 69 49 48
  618.      16.7 cpi                                 27 42 48 27 69 49 48 27 91
  619.      Italics On                               27 18
  620.      Italics Off                              27 20
  621.      Bold On                                  27 75 51
  622.      Bold Off                                 27 77
  623.      "DEAR SIR,"                              68 69 65 82 32 83 73 82 44 13 10
  624.      *
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                    11
  664.  
  665.  
  666.  
  667. Programmable Printer PopUp Users Guide                            Version 1.06
  668.  
  669.  
  670.  5.0  Acknowledgments
  671.  
  672.  
  673.      This program would not have been possible were it not for the superior
  674.      programming skill of the following individuals :
  675.  
  676.  
  677.      STAY-RES routines written by Lane H. Ferris of San Francisco, Ca.  These
  678.      public domain routines allowed me to make PPP a resident application.
  679.  
  680.  
  681.      Q SCREEN routines written by Jim LeMay of Ft. Worth, Tx.  These routines
  682.      sped up my screen displays tremendously.
  683.  
  684.  
  685.      My thanks to both of these individuals.
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726. (c) Copyright 1987, Mark Allen Neil, All Rights Reserved                    12
  727.